Modifying an Event Route

The event route modify command can be used to set an event's destination, frequency threshold, and time threshold. Events are identified by their message names. The frequency and time thresholds are used to suppress multiple event notifications in a period of time. The frequency threshold specifies the number of event notifications that are dropped during the specified time threshold before the notification is sent again. If either the frequency threshold or the time threshold is set to 0 (zero), multiple event notifications are not suppressed.

To obtain a list of events that can be modified, use the event route show command.

The following example modifies all messages named disk.* to go to a destination named diskadmin with a frequency threshold of 2 events and a time threshold of 10 minutes.

node::> event route modify -messagename disk*
-destination diskadmin -frequencythreshold 2 -timethreshold 10

Displaying Information about Event Routes

The event route show command displays the following information about events:

  • Message name

  • Severity

  • Destination or destinations

  • Frequency threshold

  • Time threshold

A detailed view of a single event route also displays a full description of the event and, if applicable, the action that can be taken to address the event. See the reference page for the command for further information.

The following example displays information about all events that have message names matching the pattern disk.*.

node::> event route show -messagename disk.*
Message                          Severity     Destinations     Freq    Time
                                                               Threshd Threshd
disk.dynamicqual.failure.cleared NOTICE         -              -       -
disk.dynamicqual.failure.invalidFile                           -       -
                                 ALERT          -
disk.dynamicqual.failure.missingFile                           -       -
                                 ALERT          -
disk.dynamicqual.failure.occurred                              -       -
                                 ALERT          -
disk.dynamicqual.failure.shutdown                              -       -
                                 EMERGENCY      -
disk.fw.autodownrev              INFORMATIONAL  -              -       -
disk.fw.downrevWarning           WARNING        -              -       -
disk.healthTrigger               WARNING        -              -       -
disk.init.badSectorSize          ERROR          -              -       -
disk.init.failureBytes           ERROR          -              -       -
disk.init.unknownDisk            ERROR          -              -       -
disk.ioReassignFailed            ALERT          -              -       -
disk.lun.LDEVMappingError        ERROR          -              -       -       
disk.lun.allMemoryAvailable      NOTICE         -              -       -
disk.lun.outOfMemory             WARNING        -              -       -
disk.lun.sizeTooLarge            ERROR          -              -       -
disk.lun.sizeTooSmall            ERROR          -              -       -
disk.senseError                  ERROR          -              -       -

Testing an Event Route

You can use the event route invoke command to generate and send a test event to verify that the event can reach its specified destination. The following example sends a test event notification for an event that has the message name disk.dynamicqual.failure.shutdown.

node::> event route invoke -messagename disk.dynamicqual.failure.shutdown